home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / clipfpcx.zip / CLFPCX.DOC < prev    next >
Text File  |  1991-05-24  |  4KB  |  92 lines
  1.  
  2.                                  Software from:
  3.  
  4.                        ▐█▐█▐█▐█ █  ╒═════════════════╕ 
  5.                        ▐█▐█▐█ █ ▐  │     Clipper     │█
  6.                        ▐█▐█ █ ▐ │  │    Developers   │█
  7.                        ▐█ █ ▐ │ │  │      Group      │█
  8.                         █ ▐ │ │ │  │   Netherlands   │█
  9.                         ▐ │ │ │ │  ╘═════════════════╛█
  10.                                      ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  11.  
  12.                 « Clipper "Fast" EGA/VGA PCX Display Library »
  13.                            For Clipper Summer '87 &
  14.                                 Clipper 5.0x
  15.  
  16.  
  17. This is the documentation for two libraries: CLFPCX87.LIB and CLFPCX50.LIB.
  18. The first for Clipper Summer '87, the latter for Clipper 5.0x (5.0 and 5.01).
  19.  
  20. These libraries provides a function that display's some PCX files, in an
  21. efficient, fast and easy manner. The memory overhead by CLFPCX is very
  22. little, as the core has been programmed directly in Assembly, and there
  23. are also very few options for extra displays etc... CLFPCX is ideal
  24. for your application just to display the Logo of your Company/Organisation. 
  25. I suggest to use other complete libraries for more elaborate graph functions.
  26.  
  27. The display of the PCX is quite fast, as the decoding and writing of the
  28. actual picture is completely handled by Assembly routines.
  29.  
  30. For each library, the source code to the FastPCX() function has been supplied,
  31. would you want to add some more robust error checking, or display more
  32. pictures in a row, or whatever..
  33.  
  34. Syntax:        FastPCX(cFileName) --> nCode
  35.  
  36. cFileName    Name of PCX file, complete (you must include .PCX!).
  37.  
  38. nCode:        Meaning:
  39. ----------------------------------------------------------
  40. 0        PCX displayed OK, still in graphmode.
  41.         Do whatever you want, (inkey()?), and return to
  42.         normal mode with the txtMode() function, also in CLFPCX??.LIB.
  43. 1        file not Found. You must include .PCX!
  44. 2        Not a PCX file!
  45. 3        Not a proper Format. The PCX file has an unknown Format.
  46.  
  47. Currently, The CLFPCX?? libraries support only these formats:
  48.  
  49. Adaptor:    Video Mode:    Resolution (WxHxColors):
  50. --------------------------------------------------------
  51. VGA         13h         320x200x256
  52. VGA        12h        640x480x16
  53. EGA/VGA        10h        640x350x16
  54.  
  55. As those are the ones generally used to make acceptable pictures, it is
  56. probably enough.
  57.  
  58. FastPCX() does not do much checking, and also only allows relatively Small
  59. PCX files to be displayed (<64Kb), This because it reads the whole
  60. picture at once. You may want to add code to check for the PCX file's size,
  61. you could also check if there is enough memory to load the File..?
  62. But, assuming it is used to display the logo, There probably is enough
  63. memory.
  64.  
  65. Files:        Comment:
  66. --------------------------------------------------------
  67. CLFPCX87.LIB    The library for Clipper Summer '87
  68. CLFPCX50.LIB    The library for Clipper 5.0 or 5.01
  69. CLFPCX87.PRG    Clipper '87 code to FastPCX(), also in .LIB
  70. CLFPCX87.PRG    Clipper 5.0[1] code to FastPCX(), also in .LIB
  71. PCX87.PRG    Simple Clipper '87 demo of the FastPCX() function.
  72. PCX50.PRG    Simple Clipper 5.0[1] demo of the FastPCX() function.
  73. BART.PCX    EGA 640x350x16 picture: Bart Simpson
  74. MJTITLE.PCX    VGA 640x480x16 picture: Title screen of Mah-Jonng VGA.
  75. MINDSCAP.PCX    VGA 320x200x256 picture: Mindscape (?) Logo.
  76.  
  77. The libraries are Public Domain, meaning that you may use them in your
  78. application without restrictions. You may not change anything when
  79. you distribute the libraries, without mentionning exactly what you changed.
  80. You may also not Charge anything for the libraries. I decline all
  81. responsability when using this library; you're free to use them, but you're
  82. on your own.
  83.  
  84. I hope you will enjoy and appreciate using this (or these) library(ies)..
  85.  
  86. Regards,
  87.  
  88. Pepijn Smits, May 1991.
  89. Helene SwarthStraat 1b
  90. 3061 cj Rotterdam
  91. Phone: 010-4135422 (Voice!)
  92.